home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / dialer_1b.readme < prev    next >
Text File  |  1994-10-08  |  7KB  |  206 lines
  1. Short:    Dialer.device is an autodialer/login program for all network software
  2. Author:   Iain Hibbert <plunky@skate.demon.co.uk>
  3. Uploader: plunky@skate.demon.co.uk
  4. Type:     comm/net
  5.  
  6.                             dialer.device 1.6
  7.  
  8.                            © 1994, Iain Hibbert
  9.  
  10.  
  11.     dialer.device is an autodialer/login program for all types of network
  12.   software that use the serial port, but don't know how to deal with modems
  13.   or login prompts.  It also enables you to have your modem hangup on DTR
  14.   drop
  15.  
  16.     dialer.device will work with *any* software that usually accesses a
  17.   serial port, such as any [C]SLIP or PPP devices for AmiTCP, any version
  18.   of AmigaNOS, any terminal program, and even the 'version' command.
  19.  
  20. 1. Installation
  21. ---------------
  22.  
  23.      This archive should contain three files:
  24.  
  25.             dialer.device       ; the autodialer
  26.             dialer0.config      ; an example configuration
  27.             dialer.readme       ; this file
  28.  
  29.      Copy dialer.device to your DEVS: directory, and create config files in
  30.    ENV: (and ENVARC:), then point your network software at dialer.device
  31.    instead of its usual serial.device.
  32.  
  33.      For automatic hangup, configure your modem to drop the line when DTR
  34.    is dropped (&D2 on most modems), then you just need to take the system
  35.    offline (in the case of AmiTCP) or exit the network software (AmigaNOS)
  36.    to hangup.
  37.  
  38. 2. Configuration
  39. ----------------
  40.  
  41.     Each unit of dialer.device can be configured differently, thus is is
  42.   possible to have several network connections using the same telephone
  43.   line. The configuration is held in a file called dialerX.config in your
  44.   ENV: directory, where X is the unit number (the unit number may be any
  45.   32-bit number). Only lines starting with valid keywords are interpreted,
  46.   this is a low-level device and no error messages are currently produced,
  47.   if you have any problems check the config file.
  48.  
  49.     When you have correctly configured dialer.device and your modem, you
  50.   can test it with the 'version' command, just type:
  51.  
  52.         version dialer.device unit 0
  53.  
  54.     at the shell prompt, and it should dial out and login to your network
  55.   provider, then hangup immediately. Success is indicated by printing the
  56.   version number of the serial device indicated by the DEVICE keyword -
  57.   this is because when dialer.device has finished its login, it steps out
  58.   of the way and leaves the network software to deal directly with the
  59.   serial device so there is no degradation in performance :-)
  60.  
  61.     The valid keywords are:
  62.  
  63.     DEVICE <string>
  64.  
  65.         The device to use. When dialer.device is successfully opened, it
  66.       returns a pointer to this device instead of itself.
  67.  
  68.         default: "serial.device"
  69.  
  70.     UNIT <number>
  71.  
  72.         The unit number of the serial device to use.
  73.  
  74.         default: 0
  75.  
  76.     BAUD <number>
  77.  
  78.         The Baud Rate to use
  79.  
  80.         default: <your prefs setting>
  81.  
  82.     INITSTRING <string>
  83.  
  84.         The first string that is sent to the modem, it should initialise
  85.       the modem, and cause it to return an OK within 5 seconds, or else the
  86.       device will return, unopened.
  87.  
  88.         default: "ATZ"
  89.  
  90.     DIALSTRING <string>
  91.  
  92.         The string we send before each phone number.
  93.  
  94.         default: "ATDT"
  95.  
  96.     PHONE <string>
  97.  
  98.         Multiple PHONE keywords are allowed. Each will be dialled in turn,
  99.       until we either get a "CONNECT", "ERROR", or "NO DIALTONE" message
  100.       from the modem, or else the window is closed.
  101.  
  102.       N.B.  If there are no numbers to dial, the dialer will assume that
  103.       there is no modem on the line and will skip directly to the CONVERSE
  104.       stage (no MODEMINIT, no Dialling)
  105.  
  106.     DIALTIMEOUT <number>
  107.  
  108.         When dialling, we will attempt to abort the dial if this many
  109.       seconds pass before we get a recognised result. The device will
  110.       continue dialling with the next number.
  111.  
  112.         default: 60
  113.  
  114.     CONVERSE <string> <string>
  115.  
  116.         Multiple CONVERSE keywords are allowed, none are required. The first
  117.       string is waited for, then the second string plus a CR is sent. To
  118.       send without waiting, leave the first string empty (ie "").
  119.  
  120.     TIMEOUT <number>
  121.  
  122.         The timeout to use when waiting for a CONVERSE string, if we
  123.       timeout, the device will fail to open.
  124.  
  125.         default: 30
  126.  
  127.     WINDOWSIZE <number> <number> <number> <number>
  128.  
  129.         Status window size when it opens
  130.  
  131.         default: 320 11 320 100
  132.  
  133.     ZOOMSIZE <number> <number> <number> <number>
  134.  
  135.         Alternative size, for when you press the Zoom gadget.
  136.  
  137.         default: 320 11 320 11
  138.  
  139.  
  140.     A <string> is delimited by spaces, or " quote characters.
  141.  
  142.     "This is one String"
  143.     This is four strings
  144.  
  145.     You can insert CR or LF into the string by using \r and \n
  146.  
  147. 3. Copyright
  148. ------------
  149.  
  150.      dialer.device is © 1994 Iain Hibbert and is  freely  distributable  as
  151.  long as all of its files are  included  in  their  original  form  without
  152.  additions, deletions, or modifications of any kind,  and  only  a  nominal
  153.  fee is charged for its distribution.
  154.  
  155.      This software is provided "AS IS" without warranty of any kind, either
  156.  expressed or implied. Reading Legal mush can turn your brain to guacamole.
  157.  By using dialer.device you accept either the whole risk or the quality and
  158.  performance of the program.
  159.  
  160. 4. The Author
  161. -------------
  162.  
  163.     Iain Hibbert         4 Avondale Road        plunky@skate.demon.co.uk
  164.                          Bath                   2:250/320.33@fidonet
  165.                          Avon BA1 3EG           39:138/14.33@amiganet
  166.                          England
  167.  
  168.      You should probably be able to reach me at one of the above addresses,
  169.  if you are using Comms software regularly.  Please contact me if  you have
  170.  any  problems  or  suggestions.  I  do  not  guarantee  to  implement  any
  171.  suggestions or fix any bugs, but it can't hurt to try.
  172.  
  173. 5. History
  174. ----------
  175.  
  176.     1.0     First Release
  177.  
  178.     1.4     1.0 would think it was successful if you aborted after
  179.             receiving the CONNECT message (ie during the login phase)
  180.  
  181.     1.6     removed the requirement to have PHONE keywords, at request
  182.  
  183. 6. Bugs
  184. -------
  185.  
  186.     Thats all, there is no more..
  187.  
  188.     Actually, there is one slight strangeness to do with the OpenDevice()
  189.   exec.library function call - *sometimes* if the device fails to open, it
  190.   tries again (once only) - this can manifest if you abort the dialling,
  191.   the dialer starts to try again (just close it again), or if the login
  192.   fails and the device tries again. I do not know why it does this.
  193.  
  194.     Any other problems, let me know..
  195.  
  196.  
  197. ============================= Archive contents =============================
  198.  
  199. Original  Packed Ratio    Date     Time    Name
  200. -------- ------- ----- --------- --------  -------------
  201.     6332    3893 38.5% 16-Jul-94 12:48:42  dialer.device
  202.     1099     567 48.4% 16-Jul-94 13:22:52  dialer0.config
  203.     6389    2686 57.9% 16-Jul-94 13:17:38  dialer.readme
  204. -------- ------- ----- --------- --------
  205.    13820    7146 48.2% 31-Jul-94 18:18:22   3 files
  206.